JavaScript Modul Sub'yekt Namunasi: Domen Obyektlarini Modellashtirishga Chuqur Kirish

Dasturiy ta'minotni ishlab chiqish dunyosida, ayniqsa dinamik va doimiy rivojlanib borayotgan JavaScript ekotizimida, biz ko'pincha tezlik, freymvorklar va funksiyalarga ustuvorlik beramiz. Biz murakkab foydalanuvchi interfeyslarini yaratamiz, son-sanoqsiz API'larga ulanamiz va ilovalarni bosh aylanadigan tezlikda joylashtiramiz. Ammo bu shoshilinchlikda, biz ba'zan ilovamizning asosiy yadrosini: biznes domenni e'tiborsiz qoldiramiz. Bu ko'pincha "Katta Loy To'pi" deb ataladigan holatga olib kelishi mumkin — biznes mantig'i tarqoq, ma'lumotlar tuzilmagan va oddiy o'zgartirish kutilmagan xatoliklar kaskadini keltirib chiqaradigan tizim.

Aynan shu yerda Domen Obyektlarini Modellashtirish yordamga keladi. Bu siz ishlayotgan muammo sohasining boy, ifodali modelini yaratish amaliyotidir. Va JavaScriptda Modul Sub'yekt Namunasi bunga erishishning kuchli, nafis va freymvorkdan mustaqil usulidir. Ushbu keng qamrovli qo'llanma sizni ushbu namunaning nazariyasi, amaliyoti va afzalliklari bilan tanishtirib, yanada mustahkam, kengaytiriladigan va qo'llab-quvvatlanadigan ilovalar yaratish imkonini beradi.

Domen Obyektlarini Modellashtirish nima?

Namunaning o'ziga sho'ng'ishdan oldin, atamalarga aniqlik kiritib olaylik. Ushbu tushunchani brauzerning Hujjat Obyekt Modeli (DOM) dan farqlash juda muhim.

• Domen: Dasturiy ta'minotda 'domen' - bu foydalanuvchining biznesi tegishli bo'lgan maxsus soha. Elektron tijorat ilovasi uchun domen Mahsulotlar, Mijozlar, Buyurtmalar va To'lovlar kabi tushunchalarni o'z ichiga oladi. Ijtimoiy media platformasi uchun esa u Foydalanuvchilar, Postlar, Sharhlar va Layklarni o'z ichiga oladi.
• Domen Obyektlarini Modellashtirish: Bu biznes domenidagi sub'yektlarni, ularning xatti-harakatlarini va munosabatlarini ifodalovchi dasturiy modelni yaratish jarayonidir. Bu real dunyo tushunchalarini kodga o'tkazishdir.

Yaxshi domen modeli shunchaki ma'lumotlar konteynerlari to'plami emas. Bu sizning biznes qoidalaringizning jonli tasviridir. Buyurtma obyekti shunchaki mahsulotlar ro'yxatini saqlamasligi kerak; u o'zining umumiy qiymatini hisoblashni, yangi mahsulot qo'shishni va uni bekor qilish mumkinmi yoki yo'qligini bilishi kerak. Ma'lumotlar va xatti-harakatlarning bu inkapsulyatsiyasi mustahkam ilova yadrosini qurishning kalitidir.

Umumiy Muammo: "Model" Qatlamidagi Anarxiya

Ko'pgina JavaScript ilovalarida, ayniqsa organik ravishda o'sib boradiganlarda, 'model' qatlami ko'pincha e'tibordan chetda qoladi. Biz tez-tez ushbu anti-namunani ko'ramiz:

            
// API kontrolleri yoki xizmatida...
async function createUser(req, res) {
  const { email, password, firstName, lastName } = req.body;

  // Biznes mantig'i va tekshiruvlar shu yerda tarqoq
  if (!email || !email.includes('@')) {
    return res.status(400).send({ error: 'Yaroqli elektron pochta manzili kerak.' });
  }

  if (!password || password.length < 8) {
    return res.status(400).send({ error: 'Parol kamida 8 ta belgidan iborat bo\'lishi kerak.' });
  }

  const user = {
    email: email.toLowerCase(),
    password: await hashPassword(password), // Qandaydir yordamchi funksiya
    fullName: `${firstName} ${lastName}`, // Hosilaviy ma'lumotlar uchun mantiq shu yerda
    createdAt: new Date()
  };

  // Endi, `user` nima? Bu shunchaki oddiy obyekt.
  // Hech narsa boshqa dasturchiga keyinroq buni qilishiga to'sqinlik qilmaydi:
  // user.email = 'an-invalid-email';
  // user.password = 'short';

  await db.users.insert(user);
  res.status(201).send(user);
}

            

              
                Copy
              
            
          

Bu yondashuv bir nechta jiddiy muammolarni keltirib chiqaradi:

• Yagona Haqiqat Manbasining Yo'qligi: Yaroqli 'foydalanuvchi' nima ekanligini belgilaydigan qoidalar shu bitta kontroller ichida aniqlangan. Agar tizimning boshqa bir qismi foydalanuvchi yaratishi kerak bo'lsa-chi? Mantni nusxalab-joylashtirasizmi? Bu nomuvofiqlik va xatoliklarga olib keladi.
• Kamqon Domen Modeli: `user` obyekti shunchaki ma'lumotlarning 'aqli zaif' xaltasidir. Uning xatti-harakati va o'z-o'zini anglash qobiliyati yo'q. Unga ta'sir qiluvchi barcha mantiq tashqarida yashaydi.
• Past Bog'liqlik: Foydalanuvchining to'liq ismini yaratish mantig'i API so'rovi/javobi bilan ishlash va parolni xeshlash bilan aralashib ketgan.
• Sinovdan O'tkazish Qiyinligi: Foydalanuvchi yaratish mantig'ini sinovdan o'tkazish uchun siz HTTP so'rovlari va javoblari, ma'lumotlar bazalari va xeshlash funksiyalarini mock qilishingiz kerak. Siz shunchaki 'foydalanuvchi' tushunchasini alohida sinab ko'ra olmaysiz.
• Yashirin Shartnomalar: Ilovaning qolgan qismi shunchaki foydalanuvchini ifodalovchi har qanday obyekt ma'lum bir shaklga ega va uning ma'lumotlari yaroqli deb 'taxmin' qilishi kerak. Hech qanday kafolatlar yo'q.

Yechim: JavaScript Modul Sub'yekt Namunasi

Modul Sub'yekt Namunasi bu muammolarni standart JavaScript modulidan (bitta fayl) foydalanib, bitta domen tushunchasi haqidagi hamma narsani aniqlash orqali hal qiladi. Ushbu modul o'sha sub'yekt uchun aniq haqiqat manbasiga aylanadi.

Modul Sub'yekti odatda fabrika funksiyasini ochib beradi. Bu funksiya sub'yektning yaroqli nusxasini yaratish uchun javobgardir. U qaytaradigan obyekt shunchaki ma'lumot emas; u o'z ma'lumotlarini, tekshiruvini va biznes mantig'ini o'z ichiga olgan boy domen obyektidir.

Modul Sub'yektining Asosiy Xususiyatlari

• Inkapsulyatsiya: U ma'lumotlarni va shu ma'lumotlar ustida ishlaydigan funksiyalarni birga to'playdi.
• Chegaradagi Tekshiruv: U yaroqsiz sub'yekt yaratishning imkoni yo'qligini ta'minlaydi. U o'z holatini himoya qiladi.
• Aniq API: U ichki amalga oshirish tafsilotlarini yashirgan holda, sub'yekt bilan o'zaro ishlash uchun toza, maqsadli funksiyalar to'plamini (ochiq API) ochib beradi.
• O'zgarmaslik: U ko'pincha tasodifiy holat o'zgarishlarining oldini olish va bashorat qilinadigan xatti-harakatlarni ta'minlash uchun o'zgarmas yoki faqat o'qish uchun mo'ljallangan obyektlarni ishlab chiqaradi.
• Portativlik: U freymvorklarga (Express, React kabi) yoki tashqi tizimlarga (ma'lumotlar bazalari, APIlar kabi) nol bog'liqlikka ega. Bu sof biznes mantig'i.

Modul Sub'yektining Asosiy Komponentlari

Keling, `User` tushunchamizni ushbu namuna yordamida qayta quramiz. Biz `user.js` (yoki TypeScript foydalanuvchilari uchun `user.ts`) faylini yaratamiz va uni bosqichma-bosqich tuzamiz.

1. Fabrika Funksiyasi: Sizning Obyekt Konstruktoringiz

Sinflar o'rniga biz fabrika funksiyasidan (masalan, `buildUser`) foydalanamiz. Fabrikalar katta moslashuvchanlikni taklif qiladi, `this` kalit so'zi bilan kurashishdan saqlaydi va JavaScriptda shaxsiy holat va inkapsulyatsiyani tabiiyroq qiladi.

Bizning maqsadimiz xom ma'lumotlarni olib, yaxshi shakllangan, ishonchli Foydalanuvchi obyektini qaytaradigan funksiya yaratishdir.

            
// fayl: /domain/user.js

export default function buildMakeUser() {
  // Bu ichki funksiya haqiqiy fabrikadir.
  // Agar kerak bo'lsa, u buildMakeUser'ga uzatilgan har qanday bog'liqliklarga kira oladi.
  return function makeUser({
    id = generateId(), // Noyob ID yaratadigan funksiya bor deb faraz qilaylik
    firstName,
    lastName,
    email,
    passwordHash,
    createdAt = new Date()
  }) {
    // ... tekshiruv va mantiq shu yerga keladi ...

    const user = {
      getId: () => id,
      getFirstName: () => firstName,
      getLastName: () => lastName,
      getEmail: () => email,
      getPasswordHash: () => passwordHash,
      getCreatedAt: () => createdAt
    };

    // Obyektni o'zgarmas qilish uchun Object.freeze ishlatilmoqda.
    return Object.freeze(user);
  }
}

            

              
                Copy
              
            
          

Bu yerda bir nechta narsaga e'tibor bering. Biz funksiya qaytaradigan funksiyadan (yuqori tartibli funksiya) foydalanmoqdamiz. Bu noyob ID generatori yoki validator kutubxonasi kabi bog'liqliklarni sub'yektni ma'lum bir amalga oshirishga bog'lamasdan kiritish uchun kuchli namunadir. Hozircha biz uni sodda saqlaymiz.

2. Ma'lumotlarni Tekshirish: Darvozadagi Qo'riqchi

Sub'yekt o'z yaxlitligini himoya qilishi kerak. `User`ni yaroqsiz holatda yaratishning imkoni bo'lmasligi kerak. Biz tekshiruvni to'g'ridan-to'g'ri fabrika funksiyasi ichiga qo'shamiz. Agar ma'lumotlar yaroqsiz bo'lsa, fabrika nima noto'g'ri ekanligini aniq ko'rsatib, xatolik chiqarishi kerak.

            
// fayl: /domain/user.js

export default function buildMakeUser({ Id, isValidEmail, hashPassword }) {
  return function makeUser({
    id = Id.makeId(),
    firstName,
    lastName,
    email,
    password, // Endi biz oddiy parolni olib, uni ichkarida qayta ishlaymiz
    createdAt = new Date()
  }) {
    if (!Id.isValidId(id)) {
      throw new Error('Foydalanuvchi yaroqli idga ega bo\'lishi kerak.');
    }
    if (!firstName || firstName.length < 2) {
      throw new Error('Ism kamida 2 ta belgidan iborat bo\'lishi kerak.');
    }
    if (!lastName || lastName.length < 2) {
      throw new Error('Familiya kamida 2 ta belgidan iborat bo\'lishi kerak.');
    }
    if (!email || !isValidEmail(email)) {
      throw new Error('Foydalanuvchi yaroqli elektron pochta manziliga ega bo\'lishi kerak.');
    }
    if (!password || password.length < 8) {
      throw new Error('Parol kamida 8 ta belgidan iborat bo\'lishi kerak.');
    }

    // Ma'lumotlarni normallashtirish va o'zgartirish shu yerda sodir bo'ladi
    const passwordHash = hashPassword(password); 
    const normalizedEmail = email.toLowerCase();

    return Object.freeze({
      getId: () => id,
      getFirstName: () => firstName,
      getLastName: () => lastName,
      getEmail: () => normalizedEmail,
      getPasswordHash: () => passwordHash,
      getCreatedAt: () => createdAt
    });
  }
}

            

              
                Copy
              
            
          

Endi tizimimizning `User` yaratmoqchi bo'lgan har qanday qismi ushbu fabrika orqali o'tishi kerak. Biz har safar kafolatlangan tekshiruvga ega bo'lamiz. Shuningdek, biz parolni xeshlash va elektron pochta manzilini normallashtirish mantig'ini inkapsulyatsiya qildik. Ilovaning qolgan qismi bu tafsilotlarni bilishi yoki ular haqida qayg'urishi shart emas.

3. Biznes Mantig'i: Xatti-harakatni Inkapsulyatsiya qilish

Bizning `User` obyektimiz hali ham biroz kamqon. U ma'lumotlarni saqlaydi, lekin hech narsa *qilmaydi*. Keling, xatti-harakat qo'shaylik — domenga xos harakatlarni ifodalovchi metodlar.

            
// ... makeUser funksiyasi ichida ...

    if (!password || password.length < 8) {
      // ...
    }

    const passwordHash = hashPassword(password);
    const normalizedEmail = email.toLowerCase();

    return Object.freeze({
      getId: () => id,
      getFirstName: () => firstName,
      getLastName: () => lastName,
      getEmail: () => normalizedEmail,
      getPasswordHash: () => passwordHash,
      getCreatedAt: () => createdAt,

      // Biznes Mantig'i / Xatti-harakat
      getFullName: () => `${firstName} ${lastName}`,
      
      // Biznes qoidasini tavsiflovchi metod
      canVote: () => {
          // Ba'zi mamlakatlarda ovoz berish yoshi 18. Bu biznes qoidasi.
          // Bizda dateOfBirth xususiyati bor deb faraz qilaylik.
          const age = calculateAge(dateOfBirth);
          return age >= 18;
      }
    });
// ...

            

              
                Copy
              
            
          

`getFullName` mantig'i endi qandaydir tasodifiy kontrollerda tarqoq emas; u `User` sub'yektining o'ziga tegishli. Endi `User` obyekti bo'lgan har bir kishi `user.getFullName()` ni chaqirib, ishonchli tarzda to'liq ismni olishi mumkin. Mantiq bir marta, bir joyda aniqlangan.

Amaliy Misol Yaratish: Oddiy Elektron Tijorat Tizimi

Keling, ushbu namunani yanada o'zaro bog'liq domenga qo'llaymiz. Biz `Product`, `OrderItem` va `Order`ni modellashtiramiz.

1. `Product` Sub'yektini Modellashtirish

Mahsulotning nomi, narxi va ba'zi zaxira ma'lumotlari bor. Uning nomi bo'lishi kerak va narxi manfiy bo'lishi mumkin emas.

            
// fayl: /domain/product.js

export default function buildMakeProduct({ Id }) {
  return function makeProduct({
    id = Id.makeId(),
    name,
    description,
    price,
    stock = 0
  }) {
    if (!Id.isValidId(id)) {
      throw new Error('Mahsulot yaroqli IDga ega bo\'lishi kerak.');
    }
    if (!name || name.trim().length < 2) {
      throw new Error('Mahsulot nomi kamida 2 ta belgidan iborat bo\'lishi kerak.');
    }
    if (isNaN(price) || price <= 0) {
      throw new Error('Mahsulot noldan katta narxga ega bo\'lishi kerak.');
    }
    if (isNaN(stock) || stock < 0) {
      throw new Error('Zaxira manfiy bo\'lmagan son bo\'lishi kerak.');
    }

    return Object.freeze({
      getId: () => id,
      getName: () => name,
      getDescription: () => description,
      getPrice: () => price,
      getStock: () => stock,
      
      // Biznes mantig'i
      isAvailable: () => stock > 0,
      
      // Yangi nusxani qaytarish orqali holatni o'zgartiradigan metod
      reduceStock: (amount) => {
        if (amount > stock) {
          throw new Error('Yetarli zaxira mavjud emas.');
        }
        // Yangilangan zaxira bilan YANGI mahsulot obyektini qaytaring
        return makeProduct({ id, name, description, price, stock: stock - amount });
      }
    });
  }
}

            

              
                Copy
              
            
          

`reduceStock` metodiga e'tibor bering. Bu o'zgarmaslik bilan bog'liq muhim tushuncha. Mavjud obyektning `stock` xususiyatini o'zgartirish o'rniga, u yangilangan qiymat bilan *yangi* `Product` nusxasini qaytaradi. Bu holat o'zgarishlarini aniq va bashorat qilinadigan qiladi.

2. `Order` Sub'yektini Modellashtirish (Agregat Ildizi)

`Order` murakkabroq. Bu Domen-Asosli Dizayn (DDD) "Agregat Ildizi" deb ataydigan narsa. Bu o'z chegarasi ichidagi boshqa, kichikroq obyektlarni boshqaradigan sub'yekt. `Order` `OrderItem`lar ro'yxatini o'z ichiga oladi. Siz mahsulotni to'g'ridan-to'g'ri buyurtmaga qo'shmaysiz; siz mahsulot va miqdorni o'z ichiga olgan `OrderItem`ni qo'shasiz.

            
// fayl: /domain/order.js

export const ORDER_STATUS = {
  PENDING: 'PENDING',
  PAID: 'PAID',
  SHIPPED: 'SHIPPED',
  CANCELLED: 'CANCELLED'
};

export default function buildMakeOrder({ Id, validateOrderItem }) {
  return function makeOrder({
    id = Id.makeId(),
    customerId,
    items = [],
    status = ORDER_STATUS.PENDING,
    createdAt = new Date()
  }) {
    if (!Id.isValidId(id)) {
      throw new Error('Buyurtma yaroqli IDga ega bo\'lishi kerak.');
    }
    if (!customerId) {
      throw new Error('Buyurtma mijoz ID'siga ega bo\'lishi kerak.');
    }

    let orderItems = [...items]; // Boshqarish uchun shaxsiy nusxa yaratish

    return Object.freeze({
      getId: () => id,
      getCustomerId: () => customerId,
      getItems: () => [...orderItems], // Tashqi o'zgartirishlarni oldini olish uchun nusxasini qaytaring
      getStatus: () => status,
      getCreatedAt: () => createdAt,
      
      // Biznes Mantig'i
      calculateTotal: () => {
        return orderItems.reduce((total, item) => {
          return total + (item.getPrice() * item.getQuantity());
        }, 0);
      },

      addItem: (item) => {
        // validateOrderItem - bu elementning haqiqiy OrderItem sub'yekti ekanligini ta'minlaydigan funksiya
        validateOrderItem(item);

        // Biznes qoidasi: takrorlanishlarni oldini olish, shunchaki miqdorni oshirish
        const existingItemIndex = orderItems.findIndex(i => i.getProductId() === item.getProductId());

        if (existingItemIndex > -1) {
          const newQuantity = orderItems[existingItemIndex].getQuantity() + item.getQuantity();
          // Bu yerda siz mavjud elementdagi miqdorni yangilaysiz
          // (Bu elementlarning o'zgaruvchan bo'lishini yoki yangilash metodiga ega bo'lishini talab qiladi)
        } else {
          orderItems.push(item);
        }
      },

      markPaid: () => {
        if (status !== ORDER_STATUS.PENDING) {
          throw new Error('Faqat kutilayotgan buyurtmalarni to\'langan deb belgilash mumkin.');
        }
        // Yangilangan status bilan yangi Buyurtma nusxasini qaytaring
        return makeOrder({ id, customerId, items: orderItems, status: ORDER_STATUS.PAID, createdAt });
      }
    });
  }
}

            

              
                Copy
              
            
          

Bu `Order` sub'yekti endi murakkab biznes qoidalarini amalga oshiradi:

• U o'z mahsulotlari ro'yxatini boshqaradi.
• U o'z umumiy qiymatini hisoblashni biladi.
• U holat o'tishlarini amalga oshiradi (masalan, siz faqat `PENDING` buyurtmasini `PAID` deb belgilashingiz mumkin).

Buyurtmalar uchun biznes mantig'i endi ushbu modul ichida toza inkapsulyatsiya qilingan, alohida sinovdan o'tkaziladigan va butun ilovangiz bo'ylab qayta ishlatilishi mumkin.

Ilg'or Namunalar va Mulohazalar

O'zgarmaslik: Bashorat Qilinuvchanlikning Asosi

Biz o'zgarmaslikka to'xtaldik. Nima uchun u bunchalik muhim? Obyektlar o'zgarmas bo'lganda, ularni ilovangiz bo'ylab qandaydir uzoq funksiya ularning holatini kutilmaganda o'zgartirib yuborishidan qo'rqmasdan uzatishingiz mumkin. Bu butun bir xatolar sinfini yo'q qiladi va ilovangizning ma'lumotlar oqimini tushunishni ancha osonlashtiradi.

Object.freeze() sayoz muzlatishni ta'minlaydi. Ichki obyektlar yoki massivlarga ega bo'lgan sub'yektlar uchun (bizning `Order` kabi), siz ehtiyotkorroq bo'lishingiz kerak. Masalan, `order.getItems()` da biz chaqiruvchining to'g'ridan-to'g'ri buyurtmaning ichki massiviga elementlarni qo'shishini oldini olish uchun nusxasini (`[...orderItems]`) qaytardik.

Murakkab ilovalar uchun Immer kabi kutubxonalar o'zgarmas ichki tuzilmalar bilan ishlashni ancha osonlashtirishi mumkin, ammo asosiy tamoyil o'zgarmaydi: sub'yektlaringizga o'zgarmas qiymatlar sifatida munosabatda bo'ling. O'zgarish zarur bo'lganda, yangi qiymat yarating.

Asinxron Operatsiyalar va Saqlashni Boshqarish

Ehtimol, bizning sub'yektlarimiz butunlay sinxron ekanligini payqagandirsiz. Ular ma'lumotlar bazalari yoki APIlar haqida hech narsa bilishmaydi. Bu qasddan qilingan va namunaning katta kuchidir!

Sub'yektlar o'zlarini saqlamasligi kerak. Sub'yektning vazifasi biznes qoidalarini amalga oshirishdir. Ma'lumotlarni ma'lumotlar bazasiga saqlash vazifasi ilovangizning boshqa bir qatlamiga, ko'pincha Xizmat Qatlami, Foydalanish Holati Qatlami yoki Repozitoriy Namunasi deb ataladigan qatlamga tegishli.

Ular qanday o'zaro ta'sir qilishadi:

            
// fayl: /use-cases/create-user.js

// Bu foydalanish holati foydalanuvchi sub'yekt fabrikasiga va ma'lumotlar bazasiga kirish funksiyasiga bog'liq.
export default function makeCreateUser({ makeUser, usersDatabase }) {
  return async function createUser(userInfo) {
    // 1. Haqiqiy domen sub'yektini yarating. Bu qadam ma'lumotlarni tekshiradi.
    const user = makeUser(userInfo);

    // 2. Tashqi ma'lumotlarni talab qiladigan biznes qoidalarini tekshiring (masalan, elektron pochtaning noyobligi)
    const exists = await usersDatabase.findByEmail({ email: user.getEmail() });
    if (exists) {
      throw new Error('Elektron pochta manzili allaqachon ishlatilmoqda.');
    }

    // 3. Sub'yektni saqlang. Ma'lumotlar bazasiga oddiy obyekt kerak.
    const persisted = await usersDatabase.insert({
      id: user.getId(),
      firstName: user.getFirstName(),
      // ... va hokazo
    });

    return persisted;
  }
}

            

              
                Copy
              
            
          

Vazifalarning bu tarzda ajratilishi kuchlidir:

• `User` sub'yekti sof, sinxron va birlik sinovidan o'tkazish oson.
• `createUser` foydalanish holati orkestratsiya uchun javobgardir va mock ma'lumotlar bazasi bilan integratsiya sinovidan o'tkazilishi mumkin.
• `usersDatabase` moduli ma'lum bir ma'lumotlar bazasi texnologiyasi uchun javobgardir va alohida sinovdan o'tkazilishi mumkin.

Serializatsiya va Deserializatsiya

Sizning sub'yektlaringiz, o'z metodlari bilan, boy obyektlardir. Ammo ma'lumotlarni tarmoq orqali (masalan, JSON API javobida) yuborganingizda yoki ma'lumotlar bazasida saqlaganingizda, sizga oddiy ma'lumotlar ko'rinishi kerak bo'ladi. Bu jarayon serializatsiya deb ataladi.

Keng tarqalgan namuna bu sub'yektingizga `toJSON()` yoki `toObject()` metodini qo'shishdir.

            
// ... makeUser funksiyasi ichida ...

    return Object.freeze({
      getId: () => id,
      // ... boshqa getterlar

      // Serializatsiya metodi
      toObject: () => ({
        id,
        firstName,
        lastName,
        email: normalizedEmail,
        createdAt
        // E'tibor bering, biz passwordHash'ni kiritmaymiz
      })
    });

            

              
                Copy
              
            
          

Teskari jarayon, ya'ni ma'lumotlar bazasi yoki API'dan oddiy ma'lumotlarni olib, uni yana boy domen sub'yektiga aylantirish — bu aynan sizning `makeUser` fabrika funksiyangiz bajaradigan ishdir. Bu deserializatsiya.

TypeScript yoki JSDoc bilan Tiplashtirish

Ushbu namuna oddiy JavaScriptda mukammal ishlasa-da, TypeScript yoki JSDoc bilan statik tiplarni qo'shish uni yanada kuchaytiradi. Tiplar sizga sub'yektingizning 'shakli'ni rasman aniqlash imkonini beradi, bu esa ajoyib avtomatik to'ldirish va kompilyatsiya vaqtidagi tekshiruvlarni ta'minlaydi.

            
// fayl: /domain/user.ts

// Sub'yektning ochiq interfeysini aniqlang
export type User = Readonly<{
  getId: () => string;
  getFirstName: () => string;
  // ... va hokazo
  getFullName: () => string;
}>;

// Fabrika funksiyasi endi User tipini qaytaradi
export default function buildMakeUser(...) {
  return function makeUser(...): User {
    // ... amalga oshirish
  }
}

            

              
                Copy
              
            
          

Modul Sub'yekt Namunasining Umumiy Afzalliklari

Ushbu namunani qabul qilish orqali siz ilovangiz o'sishi bilan ko'payib boradigan ko'plab afzalliklarga ega bo'lasiz:

• Yagona Haqiqat Manbasi: Biznes qoidalari va ma'lumotlarni tekshirish markazlashtirilgan va aniq. Qoidaga o'zgartirish faqat bir joyda kiritiladi.
• Yuqori Bog'liqlik, Past Bog'lanish: Sub'yektlar o'z-o'zini ta'minlaydi va tashqi tizimlarga bog'liq emas. Bu sizning kod bazangizni modulli va refaktoring qilishni oson qiladi.
• Oliy Darajadagi Sinovdan O'tkaziluvchanlik: Siz butun dunyoni mock qilmasdan, eng muhim biznes mantig'ingiz uchun oddiy, tezkor birlik sinovlarini yozishingiz mumkin.
• Yaxshilangan Dasturchi Tajribasi: Dasturchi `User` bilan ishlashi kerak bo'lganda, uning qo'lida aniq, bashorat qilinadigan va o'zini hujjatlashtiradigan API bo'ladi. Endi oddiy obyektlarning shaklini taxmin qilishga hojat yo'q.
• Kengaytiriluvchanlik uchun Asos: Ushbu namuna sizga barqaror, ishonchli yadro beradi. Siz ko'proq funksiyalar, freymvorklar yoki UI komponentlarini qo'shganingizda, biznes mantig'ingiz himoyalangan va izchil bo'lib qoladi.

Xulosa: Ilovangiz uchun Mustahkam Asos Yaratish

Tez harakatlanuvchi freymvorklar va kutubxonalar dunyosida, bu vositalar vaqtinchalik ekanligini unutish oson. Ular o'zgaradi. Nima qoladi - bu sizning biznes domeningizning asosiy mantig'i. Ushbu domenni to'g'ri modellashtirishga vaqt sarflash shunchaki akademik mashq emas; bu sizning dasturiy ta'minotingizning salomatligi va uzoq umr ko'rishiga qo'shishingiz mumkin bo'lgan eng muhim uzoq muddatli sarmoyalardan biridir.

JavaScript Modul Sub'yekt Namunasi bu g'oyalarni amalga oshirishning sodda, kuchli va tabiiy usulini taqdim etadi. U og'ir freymvork yoki murakkab sozlashni talab qilmaydi. U tilning asosiy xususiyatlaridan — modullar, funksiyalar va yopilishlardan foydalanib, ilovangiz uchun toza, bardoshli va tushunarli yadro yaratishga yordam beradi. Keyingi loyihangizda bitta asosiy sub'yektdan boshlang. Uning xususiyatlarini modellashtiring, yaratilishini tekshiring va unga xatti-harakat bering. Siz yanada mustahkam va professional dasturiy ta'minot arxitekturasi sari birinchi qadamni tashlagan bo'lasiz.